/*
 * Copyright 2002-2005 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.context;

/**
 * #Comment#：让容器拥有发布应用上下文事件的功能，包括容器启动事件、关闭事件等。
 * 实现ApplicationListener事件监听接口的Bean可以接收到容器事件
 * ，并对事件进行相应处理。在AbstractApplicationContext中有一个ApplicationEventMulticaster
 * ,负责保存所有的监听器，以便在容器产生上下文的时候通知事件的监听者。
 * <p>
 * 封装时间发布功能的接口,是ApplicationContext的父接口。<br/>
 * Interface that encapsulates event publication functionality. Serves as
 * super-interface for ApplicationContext.
 * 
 * @author Juergen Hoeller
 * @since 1.1.1
 * @see ApplicationContext
 * @see ApplicationEventPublisherAware
 * @see org.springframework.context.ApplicationEvent
 * @see org.springframework.context.event.EventPublicationInterceptor
 */
public interface ApplicationEventPublisher {

	/**
	 * 将应用事件通知应用所有已经注册的监听器。事件可以是框架事件（例如RequestHandledEvent）或者应用指定的事件。<br/>
	 * Notify all listeners registered with this application of an application
	 * event. Events may be framework events (such as RequestHandledEvent) or
	 * application-specific events.
	 * 
	 * @param event
	 *            the event to publish
	 * @see org.springframework.web.context.support.RequestHandledEvent
	 */
	void publishEvent(ApplicationEvent event);

}
